ETSI TS 132 356 vi i.o.o 



(2012-10) 




Digital cellular telecommunications system (Phase 2+); 
Universal Mobile Telecommunications System (UMTS); 

LTE; 

Telecommunication management; 

Communication Surveillance (CS) 

Integration Reference Point (IRP); 

Solution Set (SS) definitions 

(3GPP TS 32.356 version 11.0.0 Release 11) 



£b 



aftPlfca 



A GLOBAL IN ITI ATI VE 



3GPP TS 32.356 version 1 1 .0.0 Release 1 1 1 ETSI TS 1 32 356 V1 1 .0.0 (201 2-1 0) 



Reference 



RTS/TSGS-0532356vb00 
Keywords 



GSM, LTE, UMTS 



ETSI 

650 Route des Lucioles 
F-06921 Sophia Antipolis Cedex - FRANCE 

Tel.: +33 4 92 94 42 00 Fax: +33 4 93 65 47 16 

Siret N°348 623 562 00017 - NAF 742 C 
Association a but non lucratif enregistree a la 
Sous-Prefecture de Grasse (06) N° 7803/88 



Important notice 



Individual copies of the present document can be downloaded from: 
http://www.etsi.org 

The present document may be made available in more than one electronic version or in print. In any case of existing or 

perceived difference in contents between such versions, the reference version is the Portable Document Format (PDF). 

In case of dispute, the reference shall be the printing on ETSI printers of the PDF version kept on a specific network drive 

within ETSI Secretariat. 

Users of the present document should be aware that the document may be subject to revision or change of status. 

Information on the current status of this and other ETSI documents is available at 

http://portal.etsi.org/tb/status/status.asp 

If you find errors in the present document, please send your comment to one of the following services: 

http://portal.etsi.org/chaircor/ETSI support.asp 

Copyright Notification 

No part may be reproduced except as authorized by written permission. 
The copyright and the foregoing restriction extend to reproduction in all media. 

© European Telecommunications Standards Institute 2012. 
All rights reserved. 

DECT™, PLUGTESTS™, UMTS™ and the ETSI logo are Trade Marks of ETSI registered for the benefit of its Members. 
3GPP™and LTE™ are Trade Marks of ETSI registered for the benefit of its Members and 

of the 3GPP Organizational Partners. 
GSM® and the GSM logo are Trade Marks registered and owned by the GSM Association. 



ETSI 



3GPP TS 32.356 version 1 1 .0.0 Release 1 1 2 ETSI TS 1 32 356 V1 1 .0.0 (201 2-1 0) 



Intellectual Property Rights 



IPRs essential or potentially essential to the present document may have been declared to ETSI. The information 
pertaining to these essential IPRs, if any, is publicly available for ETSI members and non-members, and can be found 
in ETSI SR 000 314: "Intellectual Property Rights (IPRs); Essential, or potentially Essential, IPRs notified to ETSI in 
respect of ETSI standards", which is available from the ETSI Secretariat. Latest updates are available on the ETSI Web 
server ( http://ipr.etsi.org) . 

Pursuant to the ETSI IPR Policy, no investigation, including IPR searches, has been carried out by ETSI. No guarantee 
can be given as to the existence of other IPRs not referenced in ETSI SR 000 314 (or the updates on the ETSI Web 
server) which are, or may be, or may become, essential to the present document. 



Foreword 

This Technical Specification (TS) has been produced by ETSI 3rd Generation Partnership Project (3GPP). 

The present document may refer to technical specifications or reports using their 3GPP identities, UMTS identities or 
GSM identities. These should be interpreted as being references to the corresponding ETSI deliverables. 
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Foreword 



rd , 



This Technical Specification has been produced by the 3 Generation Partnership Project (3 GPP). 

The contents of the present document are subject to continuing work within the TSG and may change following formal 
TSG approval. Should the TSG modify the contents of the present document, it will be re-released by the TSG with an 
identifying change of release date and an increase in version number as follows: 

Version x.y.z 

where: 

x the first digit: 

1 presented to TSG for information; 

2 presented to TSG for approval; 

3 or greater indicates TSG approved document under change control. 

y the second digit is incremented for all changes of substance, i.e. technical enhancements, corrections, 
updates, etc. 

z the third digit is incremented when editorial only changes have been incorporated in the document. 



Introduction 

The present document is part of a TS-family covering the 3 rd Generation Partnership Project: Technical Specification 
Group Services and System Aspects; Telecommunication management; as identified below: 

TS 32.351: "Communication Surveillance (CS) Integration Reference Point (IRP): Requirements"; 

TS 32.352: "Communication Surveillance (CS) Integration Reference Point (IRP): Information Service (IS)"; 

TS 32.356: "Communication Surveillance (CS) Integration Reference Point (IRP): Solution Set (SS) 

definitions" 

The present document is part of a set of technical specifications defining the telecommunication management (TM) of 
3G systems. The TM principles are described in 3GPPTS 32.101 [1]. The TM architecture is described in 
3GPPTS 32.102 [2]. The other specifications define the interface (Itf-N) between the managing system (manager), 
which is in general the network manager (NM) and the managed system (agent), which is either an element manager 
(EM) or the managed NE itself. The Itf-N is composed of a number of integration reference points (IRPs) defining the 
information in the agent that is visible for the manager, the operations that the manager may perform on this 
information and the notifications that are sent from the agent to the manager. CS (Communication Surveillance) IRP is 
one of these IRPs with special function. 

To ensure the availability and reliability of the management, an automatic surveillance of the communication between 
NM and the managed system are required. CSIRP is defined as a capability to achieve this goal. 
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Scope 



The present document specifies the Solution Set definitions for the IRP whose semantics is specified in TS 32.352 [6] 
Communication Surveillance IRP: Information Service.. 

This Solution Set definitions specification is related to 3GPP TS 32.352 V11.0.X. 



2 References 

The following documents contain provisions which, through reference in this text, constitute provisions of the present 
document. 

• References are either specific (identified by date of publication, edition number, version number, etc.) or 
non-specific. 

• For a specific reference, subsequent revisions do not apply. 

• For a non-specific reference, the latest version applies. In the case of a reference to a 3 GPP document 
(including a GSM document), a non-specific reference implicitly refers to the latest version of that document in 
the same Release as the present document. 

[I] 3GPP TS 32.101: "Telecommunication management; Principles and high level requirements". 

[2] 3GPP TS 32.102: "Telecommunication management; Architecture". 

[3] 3GPP TS 32.351: "Telecommunication management; Communication Surveillance (CS) Integration 

Reference Point (IRP): Requirements". 

[4] 3GPP TS 32.312: "Telecommunication management; Generic Integration Reference Point (IRP): 

Information Service (IS)". 

[5] 3GPP TS 32.31 1: "Telecommunication management; Generic Integration Reference Point (IRP): 

Requirements". 

[6] 3GPP TS 32.352: "Telecommunication management; Communication Surveillance (CS) Integration 

Reference Point (IRP): Information Service (IS)". 

[7] 3GPP TS 32.306: "Telecommunication management; Configuration Management (CM); Notification 

Integration Reference Point (IRP): Solution Set (SS) definitions". 

[8] OMG TC Document telecom/9 8- 11-01: "OMG Notification Service". 

http://www.omg.org/technology/documents/ 

[9] 3GPP TS 32.300: "Telecommunication management; Configuration Management (CM); Name 

convention for Managed Objects". 

[10] 3GPP TS 32.336: "Telecommunication management; Notification Log (NL) Integration Reference Point 

(IRP): Solution Set (SS) definitions". 

[II] 3GPP TS 32.331: "Telecommunication management; Notification Log (NL) Integration Reference Point 
(IRP): Requirements". 

[12] 3GPP TR 21.905: "Vocabulary for 3GPP Specifications". 

[13] 3GPP TS 32.150: "Telecommunication management; Integration Reference Point (IRP) Concept and 

definitions". 

[14] W3C SOAP 1 . 1 specification ( http://www.w3.org/TR/2000/NOTE-SOAP-20000508/) 

[15] W3C XPath 1 .0 specification ( http://www.w3.org/TR/1999/REC-xpath-19991 1 16) 
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[16] W3C WSDL 1 . 1 specification ( http://www.w3.org/TR/2Q01/NOTE-wsdl-2QQ 10315) 

[17] W3C SOAP 1.2 specification ( http://www.w3 .org/TR/soap 1 2-part 1/) 



3 Definitions and abbreviations 

3.1 Definitions 

For the purposes of the present document, the terms and definitions given in TR 21.905 [12], 3GPP TS 32.101 [1], 
3GPPTS 32.102 [2], 3GPPTS 32.150 [13], 3GPPTS 32.351 [3], 3GPPTS 32.352 [6] and 3GPP TS 32.331 [11]. A 
term defined in the present document takes precedence over the definition of the same term, if any, in TR 21.905 [12]. 
And the following apply: 

IRP document version number string (or "IRPVersion"): see 3GPP TS 32.311 [5]. 

3.2 Abbreviations 

For the purposes of the present document, the following abbreviations apply: 

CORBA Common Object Request Broker Architecture 

CS Communication Surveillance 

CSIRP Communication Surveillance IRP 

DN Distinguished Name 

EM Element Manager 

IRP Integration Reference Point 

IOC Information Object Class 

IS Information Service 

NE Network Element 

NL Notification Log 

NM Network Manager 

NRM Network Resource Model 

SS Solution Set 

UML Unified Modelling Language 

XML extensible Markup Language 

4 Solution Set definitions 

This specification defines the following 3 GPP CS IRP Solution Set definitions: 

• 3GPP CS IRP CORBA SS (Annex A) 

• 3GPP CS IRP XML definitions (Annex B) 

• 3GPP CS IRP SOAP Solution Set (Annex C) 
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Annex A (normative): 
CORBA Solution Set 



This annex contains the CORBA Solution Set for the IRP whose semantics is specified in CS IRP: Information Service 
(TS 32.352 [6]). 



A.1 Architectural Features 

The overall architectural feature of CS IRP is specified in 3GPP TS 32.352 [6]. 
This clause specifies features that are specific to the CORBA SS. 

A.1 .1 Syntax for Distinguished Names and Versions 

The syntax of a Distinguished Name is defined in 3GPP TS 32.300 [9]. 

The version of this IRP is represented as a string (see also clause 3 for versions). 

A. 1.2 Notifications 

Notifications are sent according to the Notification IRP: CORBA SS (see 3GPP TS 32.306 [7]). 
The contents of the CS IRP notifications are defined in the present document. 



A.2 Mapping 

A.2.1 Operation and Notification mapping 

CSIRP: IS 3GPP TS 32.352 [6] defines semantics of operation and notification visible across the CSIRP. Table A.2.1 
indicates mapping of these operations and notifications to their equivalents defined in this SS. 

Table A.2.1 : Mapping from IS Operations and Notification to SS equivalents 



IS Operations/ notification TS 32.352 [6] 


SS Method 


Qualifier 


getHeartbeatPeriod 


get_heartbeat_period 


M 


setHeartbeatPeriod 


set heartbeat period 


O 


trigger-Heartbeat 


triggerjieartbeat 


M 


notifyHeartbeat 


push_structured_event (See clause A.3.1) 


M 


getlRPVersion (see note) 


get cs irp versions 


M 


getOperationProfile (see note) 


get cs irp operations profile 


O 


getNotificationProfile (see note) 


get cs irp notification profile 


O 


NOTE: This operation is of ManagedGenericIRP IOC specified in 3GPP TS 32.312 [4]. 
The CSIRP IOC of TS 32.352 [6] inherits from it. 



A.2.2 Operation parameter mapping 



The CSIRP: IS 3GPP TS 32.352 [6] defines semantics of parameters carried in operations across the CSIRP. The 
following tables indicate the mapping of these parameters, as per operation, to their equivalents defined in this SS. 
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Table A.2.2.1 : Mapping from IS getHeartbeatPeriod parameters to SS equivalents 



IS Operation parameter 


SS Method parameter 


Qualifier 


heartbeatPeriod 


CSIRPConstDefs::HeartbeatPeriod heartbeat_period 


M 


status 


Return value of type CSIRPConstDefs::Result 

Exception: 

GetHeartbeatPeriod 


M 



Table A.2.2.2: Mapping from IS setHeartbeatPeriod parameters to SS equivalents 



IS Operation parameter 


SS Method parameter 


Qualifier 


heartbeatPeriod 


CSIRPConstDefs::HeartbeatPeriod heartbeat_period 


M 


status 


Return value of type CSIRPConstDefs::Result 

Exception: 

SetHeartbeatPeriod, InvalidHeartbeatPeriod, ConflictingHeartbeatPeriod, 

ManagedGenericlRPSystem::ValueNotSupported, 

ManagedGenericlRPSystem::OperationNotSupported 


M 



Table A.2.2.3: Mapping from IS triggerHeartbeat parameters to SS equivalents 



IS Operation parameter 


SS Method parameter 


Qualifier 


managerldentifier 


CSIRPConstDefs::Managerldentifier manager identifier 


M 


status 


Return value of type CSIRPConstDefs::Result 

Exception: 

TriggerHeartbeat, InvalidManagerldentifier 


M 


NOTE: For CORBA SS, the managerldentifier of triggerHeartbeat operation shall be mapped to managerReference 
which is same as what IRPManager used to subscribe notifications [7]. 



Table A.2.2.4: Mapping from IS getiRPVersion parameters to SS equivalents 



IS Operation parameter 


SS Method parameter 


Qualifier 


versionNumberSet 


Return value of type ManagedGenericlRPConstDefs::VersionNumberSet 


M 


status 


Exception: 
GetCSIRPVersions 


M 



Table A.2.2.5: Mapping from IS getoperationProf ile parameters to SS equivalents 



IS Operation parameter 


SS Method parameter 


Qualifier 


iRPVersion 


ManagedGenericlRPConstDefs::VersionNumber irp_version 


M 


operationNameProfile, 
operationParameterProfile 


Return value of type ManagedGenericlRPConstDefs::Methodl_ist 


M 


status 


Exception: 

GetCSIRPOperationsProfile, 

ManagedGenericlRPSystem::OperationNotSupported, 

ManagedGenericlRPSystem::lnvalidParameter 


M 



Table A.2.2.6: Mapping from IS getNotif icationProf ile parameters to SS equivalents 



IS Operation parameter 


SS Method parameter 


Qualifier 


iRPVersion 


ManagedGenericlRPConstDefs::VersionNumber irp_version 


M 


notificationNameProfile, 
notificationParameterProfile 


Return value of type ManagedGenericlRPConstDefs::Methodl_ist 


M 


status 


Exception: 

GetCSIRPNotificationProfile, 

ManagedGenericlRPSystem::OperationNotSupported, 

ManagedGenericlRPSystem::lnvalidParameter 


M 



A.2.3 Notification parameter mapping 

The semantics of parameters carried in notifications are defined in CSIRP IS (3GPP TS 32.352 [6]). 

Table A.2.3 indicates the mapping of these parameters to their OMG CORBA Structured Event [8] equivalents. 

The composition of OMG Structured Event, as defined in [8] is: 



ETSI 



3GPP TS 32.356 version 11.0.0 Release 11 



10 



ETSI TS 132 356 V1 1.0.0 (2012-10) 



Header 



Body 



Fixed Header 

domain_name 

type_name 

event_name 
Variable Header 

f ilterable_body_f ields 
remaining_body 



Table A.2.3 lists in the second column all OMG Structured Event attributes. The first column identifies the notification 
parameters defined in CSIRP IS (3GPP TS 32.352 [6]). 
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Table A.2.3: Mapping for notifyHeartBeat 



IS Parameters 


OMG CORBA 

Structured 
Event attribute 


Qualifier 


Comment 


There is no corresponding 
IS attribute. 


domain_name 


M 


It carries the IRP document version number string. See 
clause 3.1. 

It indicates the syntax and semantics of the Structured Event as 
defined by the present document. 


not i f i cat ionType 


type name 


M 


This is the ET HEARTBEAT of module of CSIRPConstDefs. 


There is no corresponding 
IS attribute 


event_name 


M 


It carries no information. 


There is no corresponding 
IS attribute. 


Variable Header 






objectClass, 
objectlnstance 


One NV pair of 

filterable_body_f 

ields 


M 


NV stands for name-value pair. Order arrangement of NV pairs is 
not significant. The name of NV-pair is always encoded in string. 

Name of this NV pair is the MANAGED_OBJECT_INSTANCE of 
interface AttributeNameValue of module 
NotificationlRPConstDefs. 

Value of NV pair is a string. See corresponding table in 
Notification IRP: CORBA SS of [7]. 


notificationld 


One NV pair of 
remainingjDody 


M 


Name of NV pair is the NOTIFICATIONJD of interface 
AttributeNameValue of module NotificationlRPConstDefs. 

Value of NV pair is a long. See corresponding table in Notification 
IRP: CORBA SS of [7]. 


eventTime 


One NV pair of 

filterable_body_f 

ields 


M 


Name of NV pair is the EVENT_TIME of interface 
AttributeNameValue of module NotificationlRPConstDefs. 

Value of NV pair is IRPTime. See corresponding table in 
Notification IRP: CORBA SS of [7]. 


system DN 


One NV pair of 

filterable_body_f 

ields 


M 


Name of NV pair is the SYSTEM_DN of interface 
AttributeNameValue of module NotificationlRPConstDefs. 

Value of NV pair is a string. See corresponding table in 
Notification IRP: CORBA SS of [7]. 


heartbeatPeriod 


One NV pair of 
remaining_body 


M 


Name of NV pair is the HEARTBEAT_PERIOD of interface 
NotifyHeartbeat of module CSIRPNotifications. 

Value of NV pair is a CSIRPConstDefs::HeartbeatPeriod. 


triggerFlag 


One NV pair of 
remaining_body 


M 


Name of NV pair is the TRIGGER_FLAG of interface 
NotifyHeartbeat of module CSIRPNotifications. 

Value of NV pair is a CSIRPConstDefs::TriggerFlag. 


locator 


One NV pair of 
remaining_body 


M 


Name of NV pair is the CHANNELJD of interface NotifyHeartbeat 
of module CSIRPNotifications. 

Value of NV pair is a CSIRPConstDefs::Channelld. 

This parameter shall be mapped to an identifier of channel. For 
definition of channel, see OMG Notification Service [8]. 

The CHANNELJD carry the same meaning but may or may not 
carry the same value used by OMG defined Channel ID. 


managerldentifier 


One NV pair of 
remaining_body 


M 


Name of NV pair is the MANAGERJDENTIFIER of interface 
NotifyHeartbeat of module CSIRPNotifications. 

Value of NV pair is a CSIRPConstDefs::Managerldentifier. 
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A.3 CSIRPNotification Interface 

OMG CORBA Notification push operation is used to realise the notification of CSlRPNotif ications. All the 
notifications in this interface are implemented using this push_st rue tured_e vent method. 

A.3.1 Method push (M) 

module CosNotifyComm { 

Interface SequencePushConsumer : NotifyPublish { 
void push_structured_events ( 

in CosNotif ication: : EventBatch notifications) 
raises ( CosEventComm: : Disconnected) ; 

} ; // SequencePushConsumer 

}; // CosNotifyComm 

NOTE 1: The push_structured_events method takes an input parameter of type EventBatch as defined 
in the OMG CosNotif ication module (OMG Notification Service [8]). This data type is the same as 
a sequence of Structured Events. Upon invocation, this parameter will contain a sequence of Structured 
Events being delivered to IRPManager by IRP Agent to which it is connected. 

NOTE 2: The maximum number of events that will be transmitted within a single invocation of this operation is 
controlled by IRP Agent wide configuration parameter. 

NOTE 3: The amount of time the supplier (IRP Agent) of a sequence of Structured Events will accumulate 
individual events into the sequence before invoking this operation is controlled by IRP Agent wide 
configuration parameter as well. 

NOTE 4: IRP Agent may push EventBatch with only one Structured Event. 



A.4 Solution Set definitions 
A.4.1 IDL definition structure 

Clause A.4. 2 defines the constants and types used by the CS IRP. 

Clause A.4. 3 defines the operations which are performed by the CS IRP agent. 

Clause A.4. 4 defines the notifications which are performed by the CS IRP agent. 
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A.4.2 IDL specification 'CSIRPConstDefs.idl' 

//File: CSIRPConstDefs.idl 
#ifndef _CS_IRP_CONST_DEFS_IDL_ 
#define _CS_IRP_CONST_DEFS_IDL_ 

// This statement must appear after all include statements 
#pragma prefix "3gppsa5.org" 

/* ## Module: CSIRPConstDefs 

This module contains commonly used definitions for CSIRP. 



*/ 

module CSIRPConstDefs 

{ 

typedef unsigned short Heartbeat Period; 

/* 

If notifyHeartbeat is triggered by NM positively by invoking 

triggerHeartbeat operation, the value of this parameter shall be IRPManager, 
otherwise, it shall be IRPAgent . 

*/ 

enum TriggerFlag {IRPManager, IRPAgent}; 

typedef string Managerldentif ier; 
typedef string Channel Id; 

/* 

It specifies whether the operation is success or failed. 

*/ 

enum Result {SUCCESS, FAILURE}; 

/** 

* This block identifies attributes which are included as part of the 

* CommunicationSurveillanceIRP . These attribute values should not 

* clash with those defined for the attributes of notification 

* header (see IDL of Notification IRP) . 

*/ 

interface AttributeNameValue 

{ 

const string HEARTBEAT_PERIOD = "HEARTBEAT_PERIOD" ; 

const string CHANNEL_ID = "CHANNEL_ID" ; 

const string TRIGGER_FLAG = "TRIGGER_FLAG" ; 

const string MANAGER_IDENTIFIER = "MANAGER_IDENTIFIER" ; 



#endif // _CS_IRP_CONST_DEFS_IDL_ 
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A.4.3 IDL specification 'CSIRPSystem.ioT 

//File: CSIRPSystem.idl 
#ifndef _CS_IRP_SYSYEM_IDL_ 
#define _CS_IRP_SYSYEM_IDL_ 

#include <ManagedGenericIRPSystem. idl> 
#include <ManagedGenericIRPConstDef s . idl> 
#include <CSIRPConstDef s . idl> 

// This statement must appear after all include statements 
#pragma prefix "3gppsa5.org" 

/* ## Module: CSIRPSystem 

This module implements capabilities of CSIRP. 



*/ 

module CSIRPSystem 

{ 

/** 

* The InvalidHeartbeatPeriod exception is used when the period 

* value to be set by IRPManager is not a reasonable in IRPAgent ' s 

* implementation. A very short period may cause IRPAgent to 

* send many heartbeat notification in a short time, which may 

* decrease the performance of IRPAgent. To prevent this, 

* IRPAgent may set the lower limit period in its system 

* implemntation. When the period to be set is shorter the 

* lower limit period, IRPAgent may throw this exception 

* and reject to set the period to new value. 

* Note: set the period to zero must be allowed. The behaviour of 

* setting period to zero pis see definition for Period. 

*/ 

exception InvalidHeartbeatPeriod 

{ 

unsigned short period_lower_limit ; 
string reason; 



exception InvalidManagerldentif ier { string reason; } ; 
exception Conf lictingHeartbeatPeriod { string reason; } ; 

/* 

System fails to complete the operation. System can provide reason 
to qualify the exception. The semantics carried in reason 
is outside the scope of this IRP. 

*/ 

exception GetHeartbeatPeriod { string reason; } ; 
exception SetHeartbeatPeriod { string reason; } ; 
exception TriggerHeartbeat { string reason; } ; 
exception GetCSIRPVersions { string reason; } ; 
exception GetCSIRPOperationsProf ile { string reason; } ; 
exception GetCSIRPNotif icationProf ile { string reason; } ; 

interface CSIRP 

{ 

/** 

* IRPManager invokes this operation to obtain the current 

* heartbeat period. 

*/ 

CSIRPConstDefs: : Result get_heartbeat_period ( 

out CSIRPConstDefs : :HeartbeatPeriod heartbeat_period 
) 
raises (GetHeartbeatPeriod) ; 

/** 

* IRPManager invokes this operation to set the heartbeatPeriod. 

* If the heartbeatPeriod is modified by one IRPManager, a 

* notifyHeartbeat notification should be emitted 

* immediately to all the subscribed IRPManagers to indicate 

* the new heartbeatPeriod. If the heartbeatPeriod is set to 

* zero, one notifyHeartbeat notification will be 

* emitted immediately and no more 

* notifications unless the heartbeatPeriod is modified again. 
*/ 
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CSIRPConstDef s : : Result set_heartbeat_period ( 

in CSIRPConstDef s : :HeartbeatPeriod heartbeat_period 
) 
raises (SetHeartbeatPeriod, 

Conf lie tingHeartbeat Period, 

InvalidHeartbeat Period, 

ManagedGenericIRPSystem: : ValueNotSupported, 

ManagedGenericIRPSystem: :OperationNotSupported) ; 

/* 

* IRPManager invoke this operation to trigger ET_HEARTBEAT 

* notification positively. 

*/ 

CSIRPConstDef s : : Result trigger_heartbeat ( 

in CSIRPConstDef s : rManagerldentifier manage r_i dent if ier 
) 
raises (TriggerHeartbeat , InvalidManagerldentif ier) ; 

/** 

* Return the list of all supported CSIRP versions. 

*/ 

ManagedGenericIRPConstDef s : : VersionNumberSet get_cs_irp_versions ( 

) 

raises (GetCSIRPVersions) ; 

/** 

* Return the list of all supported operations and their supported 

* parameters for a specific CSIRP version. 

*/ 

ManagedGenericIRPConstDef s : :MethodList get_cs_irp_operations_prof ile ( 

in ManagedGenericIRPConstDef s : : VersionNumber irp_version 
) 
raises (GetCSIRPOperationsProf ile, 

ManagedGenericIRPSystem: :OperationNotSupported, 

ManagedGenericIRPSystem: : InvalidParameter) ; 

/** 

* Return the list of all supported notifications and their supported 

* parameters for a specific CSIRP version. 

*/ 

ManagedGenericIRPConstDef s : :MethodList get_cs_irp_notif ication_prof ile ( 

in ManagedGenericIRPConstDef s :: VersionNumber irp_version 
) 
raises (GetCSIRPNotif icationProf ile, 

ManagedGenericIRPSystem: :OperationNotSupported, 

ManagedGenericIRPSystem: : InvalidParameter) ; 



#endif // CS IRP SYSTEM IDL 
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A.4.4 IDL specification 'CSIRPNotifications.ioT 

//File: CSIRPNotif ications. idl 
#ifndef _CS_IRP_NOTIFICATIONS_IDL_ 
#define _CS_IRP_NOTIFICATIONS_IDL_ 

#include <CSIRPConstDef s . idl> 

#include <Notif icationlRPNotif ications . idl> 

// This statement must appear after all include statements 
#pragma prefix "3gppsa5.org" 

/* ## Module: CSIRPNotif ications 

This module contains the specification of all notifications of CS IRPAgent . 

*/ 

module CSIRPNotif ications 

{ 

/* * 

* Constant definitions for the FileReady notification 

*/ 

interface NotifyHeartbeat : Notif icationlRPNotif ications : :Notify 

{ 

const string EVENT_TYPE = "notif yHeartbeat " ; 

/* * 

* This constant defines the name of the period property, 

* which is transported in the f ilterable_body fields. 

* The data type for the value of this property 

* is CSIRPConstDefs: :HeartbeatPeriod. 

*/ 

const string HEARTBEAT_PERIOD = CSIRPConstDefs : : AttributeName Value :: HEARTBEAT_PERIOD; 

/* 

* This constant defines the name of the 

* channelld property, 

* which is transported in the f ilterable_body 

* fields. 

* The data type for the value of this property 

* is CSIRPConstDefs: : Channelld. 

*/ 

const string CHANNEL_ID = CSIRPConstDefs :: AttributeName Value :: CHANNEL_ID; 

/* 

* This constant defines the name of the 

* triggerFlag property, 

* which is transported in the f ilterable_body 

* fields. 

* The data type for the value of this property 

* is CSIRPConstDefs: : TriggerFlag. 

*/ 

const string TRIGGER_FLAG = CSIRPConstDefs :: AttributeName Value :: TRIGGER_FLAG; 

/* 

* This constant defines the name of the 

* manager Ident if ier property, 

* which is transported in the f ilterable_body 

* fields. 

* The data type for the value of this property 

* is CSIRPConstDefs : : Manager Ident if ier . 

*/ 

const string MANAGER_IDENTIFIER = CSIRPConstDefs :: AttributeName Value : :MANAGER_IDENTIFIER; 



#endif // CS IRP NOTIFICATIONS IDL 
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Annex B (normative): 
XML definitions 



The annex specifies the XML Definitions for the CS Integration Reference Point (IRP) as it applies to Itf-N, in 
accordance with CS IRP IS definitions [6], for usage with the Notification Log IRP XML Definitions [10]. 



B.1 Architectural features 

The overall architectural feature of CS IRP is specified in 3GPP TS 32.352 [6]. 
This clause specifies features that are specific to the XML Schema definitions. 

B.1 .1 Syntax for Distinguished Names 

The syntax of a Distinguished Name is defined in 3GPP TS 32.300 [9]. 



B.2 Mapping 



Not present in the current version of this specification. 



B.3 Solution Set definitions 
B.3.1 XML definition structure 

Clause B.3. 2 provides a graphical representation of the XML elements. 

Clause B.3.3 provides XML definitions of CS IRP notifications as defined in 3GPP TS 32.352 [6]. 

Clause B.3.4 provides XML definitions of CS IRP IOCs as defined in 3GPP TS 32.352 [6]. 



B.3.2 Graphical Representation 
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B.3.3 XML Schema 'cSIRPNotif.xscT 

<?xml version="1.0" encoding="UTF-8" ?> 
< ! -- 

3GPP TS 32.356 CSIRP Notification XML Schema 
cSIRPNotif .xsd 
- - > 

<schema xmlns :xc="http : //www. 3gpp . org/f tp/specs/archive/32_series/32 . 356#cSIRPNotif " 
xmlns :xci="http: //www. 3gpp.org/ftp/specs/archive/32_series/32 . 3 5 6#cSIRPIOCs" 
xmlns :xe="http : //www. 3gpp . org/f tp/specs/archive/32_series/32 . 306#notif ication" 
xmlns="http: //www.w3 . org/2 l/XMLSchema" 

targetNamespace="http : //www. 3gpp . org/f tp/specs/archive/32_series/32 . 356#cSIRPNotif " 
elementFormDef ault= "qualified" attributeFormDef ault= "unqualified" > 

<import namespace="http : //www. 3gpp . org/f tp/specs/archive/32_series/32 . 356#cSIRPIOCs"/> 
< import namespace="http: //www. 3gpp.org/ftp/specs/archive/32_series/32 . 3 6#not if ication" /> 
<simpleType name="TriggerFlag" > 
<restriction base="string" > 

<enumeration value="IRPManager"/> 
<enumerat ion value= " IRPAgent " / > 
< /restrict ion> 
</simpleType> 

<complexType name="NotifyHeartbeat " > 
<complexContent> 

<extension base="xe :Notif ication" > 
<sequence> 

< element name = "body" > 
<complexType> 
<sequence> 

<element name="heartbeatPeriod" type="xci :HeartbeatPeriod"/> 
<element name=" locator" type=" string" /> 
<element name="triggerFlag" type="xc :TriggerFlag"/> 
<element name="managerldentif ier" type=" string" minOccurs=" 0"/- 
</sequence> 
</complexType> 
</element> 
</sequence> 
</extension> 
</complexContent> 
</complexType> 

<element name="NotifyHeartbeat " type="xc :NotifyHeartbeat "/> 
</schema> 
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B.3.4 XML Schema ■cSIRPIOC.xsd' 

<?xml version="l . 0" encoding="UTF-8" ?> 
< ! -- 

3GPP TS 32.356 CSIRP Notification XML Schema 
cSIRPIOCs.xsd 
- - > 

<schema xmlns :xci="http : //www. 3gpp . org/f tp/specs/archive/32_series/32 . 356#cSIRPIOCs" 
xmlns :xe="http : //www. 3gpp . org/f tp/specs/archive/32_series/32 . 306#notif ication" 
xmlns="http: //www.w3 . org/2 l/XMLSchema" 

targetNamespace="http : //www. 3gpp . org/f tp/specs/archive/32_series/32 . 356#cSIRPIOCs" 
elementFormDef ault= "qualified" attributeFormDef ault= "unqualified" > 
<simpleType name="HeartbeatPeriod" > 
<restriction base="unsignedLong" > 
<f ractionDigits value="0"/> 
<minlnclusive value="5"/> 
<maxlnclusive value="60"/> 
< /restrict ion> 
</simpleType> 
<simpleType name="CountDownTimer" > 

<restriction base= "unsignedLong" > 

<maxlnclusive value="60"/> 
< /restrict ion> 
</simpleType> 

<!-- attributes of the CSIRP IOC --> 

<element name="heartbeatPeriod" type="xci :HeartbeatPeriod"/> 
<element name= " countDownTimer " type="xci : CountDownTimer"/> 

</schema> 
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Annex C (normative): 
SOAP Solution Set 



The overall architectural feature of CM IRP is specified in 3GPP TS 32.352 [6]. 
This clause specifies features that are specific to the SOAP SS. 



C.1 Architectural Features 

C.1 .1 Syntax for Distinguished Names and versions 

The syntax of a Distinguished Name is defined in 3GPP TS 32.300 [9]. 
The version of this IRP is represented as a string (see also clause 3.1). 

C.1. 2 General 

The SOAP 1.1 specification [14] and WSDL 1.1 specification [16] are supported. 

The SOAP 1.2 specification [17] is supported optionally. 

This specification uses "document" style in WSDL file. 

This specification uses "literal" encoding style in WSDL file. 

The filter language used in the SS is the XPath Language (see W3C XPath 1.0 specification [15]). IRP Agents may 
throw a FilterComplexityLimit fault when a given filter is too complex. 

Relevant definitions are imported from the CSIRP XML definitions of Annex B. 

This specification uses a number of namespace prefixes throughout that are listed in Table C.1. 2. 

Table C.1. 2: Prefixes and Namespaces used in this specification 



PREFIX 


NAMESPACE 


(no prefix) 


http://schemas.xmlsoap.org/wsdl/ 


soap 


http://schemas.xmlsoap.org/wsdl/soap/ 


cslRPSystem 


http://www.3gpp.0rg/ftp/specs/archive/32_series/32.356#CSIRPSystem 


cslRPData 


http://www.3gpp.org/ftp/specs/archive/32 series/32.356#CSIRPData 


genericlRPSystem 


http://www.3gpp.org/ftp/specs/archive/32 series/32.31 6#GenericlRPSystem 


ntflRPNtfSystem 


http://www.3gpp.Org/ftp/specs/archive/32_series/32.306#NotificationlRPNtfSystem 
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C.2 Mapping 

C.2.1 Operation and Notification mapping 

The CS IRP IS (3GPP TS 32.352 [6]) defines semantics of operation and notification visible across the Itf-N. Table 
C.2.1 indicates mapping of these operations and notifications to their equivalents defined in this SS. 

Table C.2.1 : Mapping from IS Operation to SS Equivalents 



IS Operations in 3GPP TS 32.352 [6] 


SS Operations 


SS Port 


Qualifier 


getHeartbeatPeriod 


getHeartbeatPeriod 


NLIRPOperationslPort 


M 


setHeartbeatPeriod 


setHeartbeatPeriod 


NLIRPOperations2Port 


O 


triggerHeartbeat 


triggerHeartbeat 


NLIRPOperationslPort 


M 


notifyHeartbeat 


notify (note 1 ) 


NotificationlRPNtfPort 


M 


NOTE 1 : The IS equivalent maps to an XML definition specified in Annex B, and this being an input parameter to the 
operation notify under the port type ntflRPNtfSystem:NotificationlRPNtf and under the binding 
ntflRPNtfSystem:NotificationlRPNtf of 3GPP TS 32.306 [7]. 



C.2. 2 Operation parameter mapping 

The CS IRP IS (3GPP TS 32.352 [6]) defines semantics of parameters carried in the operations. The tables below show 
the mapping of these parameters, as per operation, to their equivalents defined in this SS. 

Table C.2. 2.1 : Mapping from IS getHeartbeatPeriod parameters to SS equivalents 



IS Operation parameter 


SS Method parameter 


Qualifier 


heartbeatPeriod 


heartbeatPeriod 


M 


status 


status 


M 



Table C.2.2.2: Mapping from IS setHeartbeatPeriod parameters to SS equivalents 



IS Operation parameter 


SS Method parameter 


Qualifier 


heartbeatPeriod 


heartbeatPeriod 


M 


status 


status 


M 



Table C.2.2.3: Mapping from IS triggerHeartbeat parameters to SS equivalents 



IS Operation parameter 


SS Method parameter 


Qualifier 


managerldentifier 


managerldentifier 


M 


status 


status 


M 



C.2.3 Notification parameter mapping 

The CS IRP Notifications are defined in Annex B. 



C.3 Solution Set definitions 



C.3.1 WSDL definition structure 

Clause C.3. 2 provides a graphical representation of the CS IRP service. 
Clause C.3. 3 defines the services which are supported the CS IRP agent. 
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C.3.2 Graphical Representation 



The WSDL structure is depicted in Figure C.3.2 below, depicting port type, binding and service. The port type contains 
port type operations, which again contains input, output and fault messages. The binding contains binding operations, 
which have the same name as the port type operations. The binding connects to a port inside the service. 



Port Types 



Bindings 



Services 



CSIRPOperationsI 
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getHeartbeatPeriod 
trigger-Heartbeat 


getHeartbeatPeriod 
triggerHeartbeat 








CSIRPService 
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GenericlRPPort 














NotificationlRPNtfPort 




GenericlRPBinding 
(from 32.316) 
























NotificationlRPNtf 
(from 32.306) 

















Figure C.3.2: CSIRP SOAP Solution Set WSDL structure 
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C.3.3 WSDL specification 'CSIRPSystem.wsoT 

<?xml version="l . 0" encoding="UTF-8" ?> 

3GPP TS 32.356 Communication Surveillance IRP SOAP Solution Set 
- - > 

<def initions xmlns="http: //schemas .xmlsoap.org/wsdl/" 
xmlns : soap="http: //schemas .xmlsoap.org/wsdl/soap/" 

xmlns : csIRPSystem="http : //www. 3gpp.org/ftp/specs/archive/32_series/32 . 356#CSIRPSystem" 
xmlns : csIRPData="http : //www. 3gpp . org/f tp/specs/archive/32_series/32 . 356#CSIRPData" 
xmlns :genericIRPSystem="http : //www. 3gpp . org/f tp/specs/archive/32_series/32 . 316#GenericIRPSystem" 
xmlns :ntf IRPNtf System="http : //www. 3gpp . org/f tp/specs/archive/32_series/32 . 306#Notif icationlRPNtf Syst 
em" 
targe tNamespace= "http : //www. 3gpp . org/f tp/specs/archive/32_series/32 . 3 5 6#CSIRPSystem" > 

< import namespace="http: //www. 3gpp.org/ftp/specs/archive/32_series/32 . 316#GenericIRPSystem"/> 
< import 
namespace="http : //www. 3gpp . org/f tp/specs/archive/32_series/32 . 306#Notif icationlRPNtf System"/> 
<types> 

<schema targetNamespace="http : //www. 3gpp . org/f tp/specs/archive/32_series/32 . 356#CSIRPData" 
xmlns= "http : //www . w3 . org/2 01 /XMLS enema" > 
<!-- getHeartbeatPeriod Request --> 
<element name="getHeartbeatPeriodRequest" > 
</element> 

<!-- getHeartbeatPeriod Response --> 
<element name="getHeartbeatPeriodResponse" > 
<complexType> 
<sequence> 

<element name="heartbeatPeriod" type="nonNegativeInteger"/> 
<element name= " status " > 
<simpleType> 

<restriction base="string" > 

enumeration value="OperationSucceeded"/> 
<enumeration value="0perationFailed"/> 
< /restrict ion> 
</simpleType> 
</element> 
</sequence> 
</complexType> 
</element> 

<!-- getHeartbeatPeriod Fault --> 
<element name= "getHeartbeatPeriodFault " > 
<simpleType> 

<restriction base="string" > 

<enumeration value="0perationFailed"/> 
< /restrict ion> 
</simpleType> 
</element> 

<!-- triggerHeartbeat Request --> 
<element name= " triggerHeartbeatRequest " > 
<complexType> 
<sequence> 

<element name="managerldentif ier" type=" string" /> 
</sequence> 
</complexType> 
</element> 

<!-- xx Response --> 

<element name= " triggerHeartbeatResponse " > 
<complexType> 
<sequence> 

<element name= " status " > 
<simpleType> 

<restriction base="string" > 

enumeration value="OperationSucceeded"/> 
<enumeration value="0perationFailed"/> 
< /restrict ion> 
</simpleType> 
</element> 

<element name="f ailureReason" minOccurs="0" > 
<simpleType> 

<restriction base="string" > 

<enumeration value="invalidManagerIdentif ier"/> 

enumeration value="operation_f ailed_invalid_input_parameter"/> 
enumeration value="operation_f ailed_internal_problem"/> 
< /restrict ion> 
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</simpleType> 
</element> 
</sequence> 
</complexType> 
</element> 

<!-- triggerHeartbeat Fault --> 
<element name= " triggerHeartbeatFault " > 
<simpleType> 

<restriction base="string" > 

enumeration value="OperationFailed"/> 
< /restrict ion> 
</simpleType> 
</element> 

<!-- setHeartbeatPeriod Request --> 
<element name= " setHeartbeatPeriodRequest " > 
< c omp 1 exTyp e > 
<sequence> 

<element name="heartbeatPeriod" type="nonNegativeInteger"/> 
</sequence> 
</complexType> 
</element> 

<!-- setHeartbeatPeriod Response --> 
<element name= " setHeartbeatPeriodResponse " > 
<complexType> 
<sequence> 

<element name= " status " > 
<simpleType> 

<restriction base="string"> 

<enumeration value="OperationSucceeded"/> 
<enumeration value="OperationFailed"/> 
< /restrict ion> 
</simpleType> 
</element> 

<element name="f ailureReason" minOccurs=" 0" > 
<simpleType> 

<restriction base="string"> 

<enumeration value="invalidHeartbeatPeriod"/> 
< enumeration value="conf lict ingHeartbeat Period" /> 
enumeration value="operation_f ailed_invalid_input_parameter"/> 
enumeration value="operation_f ailed_internal_problem"/> 
< /restrict ion> 
</simpleType> 
</element> 
</sequence> 
</complexType> 
</element> 

<!-- setHeartbeatPeriod Fault --> 
element name= " setHeartbeatPeriodFault " > 
<simpleType> 

<restriction base="string" > 

enumeration value="OperationFailed"/> 
< /restrict ion> 
</simpleType> 
</element> 
</schema> 
</types> 
<message name= "getHeartbeatPeriodRequest " > 

<part name= "parameter" element= " csIRPData : getHeartbeatPeriodRequest " / > 
</message> 
<message name="getHeartbeatPeriodResponse" > 

<part name= "parameter" element= " csIRPData : getHeartbeatPeriodResponse " /> 
</message> 
<message name= "getHeartbeatPeriodFault " > 

<part name= "parameter" element= " csIRPData : getHeartbeatPeriodFault " / > 
</message> 
<message name= " triggerHeartbeatRequest " > 

<part name= "parameter" element= " csIRPData : triggerHeartbeatRequest " / > 
</message> 
<message name= " triggerHeartbeatResponse " > 

<part name= "parameter" element="csIRPData : triggerHeartbeatResponse" /> 
</message> 
<message name= "triggerHeartbeatFault " > 

<part name= "parameter" element="csIRPData : triggerHeartbeatFault "/> 
</message> 
<message name= " setHeartbeatPeriodRequest " > 

<part name= "parameter" element="csIRPData : setHeartbeatPeriodRequest "/> 
</message> 
<message name=" setHeartbeatPeriodResponse "> 
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<part name= "parameter" element ="csIRPDat a : setHeartbeatPeriodResponse"/> 
</message> 
<message name= " setHeartbeatPeriodFault " > 

<part name= "parameter" element="csIRPData : setHeartbeatPeriodFault "/> 
</message> 
<portType name="CSIRPOperationsl" > 

<operation name="getHeartbeatPeriod" > 

< input message= " csIRPSystem : getHeartbeatPeriodRequest " / > 
< output message= " csIRPSystem : getHeartbeatPeriodResponse " / > 

<f ault name= "getHeartbeatPeriodFault " message= "csIRPSystem : getHeartbeat PeriodFault " / > 
</operation> 
<operation name="triggerHeartbeat " > 

<input message=" csIRPSystem: triggerHeartbeatRequest "/> 
<output message= "csIRPSystem : triggerHeartbeatResponse " / > 

<f ault name= " triggerHeartbeatFault " message= "csIRPSystem : triggerHeartbeatFault " / > 
</operation> 
< /port Type > 
<portType name= " CSIRPOperat ions2 " > 

<operation name= " setHeartbeatPeriod" > 

<input message= "csIRPSystem : setHeartbeatPeriodRequest " / > 
<output message= "csIRPSystem : setHeartbeatPeriodResponse " / > 

<f ault name= " setHeartbeatPeriodFault " message= "csIRPSystem : setHeartbeatPeriodFault " / > 
</operation> 
< /port Type > 
<binding name="CSIRPOperationsl" type= " csIRPSystem : CSIRPOperationsl" > 

<soap : binding style= "document " transport= "http : //schemas . xmlsoap . org/soap/http" /> 
<operation name= "getHeartbeatPeriod" > 
<soap : operation 
soapAction= "http : //www. 3gpp . org/ ftp/ specs /archive/ 3 2_series/ 3 2 . 3 5 6#getHeartbeatPeriod" 
style= " document " / > 
< input > 

<soap:body use=" literal "/> 
</ input > 
<output> 

<soap:body use=" literal "/> 
</output> 
<f ault name= "getHeartbeatPeriodFault " > 

<soap: fault name= "getHeartbeatPeriodFault" use=" literal "/> 
</fault> 
</operation> 

<operation name="triggerHeartbeat " > 
<soap : operation 
soapAction="http : //www. 3gpp . org/f tp/specs/archive/32_series/32 . 356#triggerHeartbeat" 
style= " document " / > 
< input > 

<soap:body use=" literal "/> 
</ input > 
<output> 

<soap:body use=" literal "/> 
</output> 
<fault name=" triggerHeartbeatFault "> 

<soap: fault name=" triggerHeartbeatFault" use="literal"/> 
</fault> 
</operation> 
</binding> 
<binding name= " CSIRPOperat ions2 " type= "csIRPSystem : CSIRPOperat ions2 " > 

<soap : binding style= "document " transport= "http : //schemas . xmlsoap . org/soap/http" /> 
<operation name= " setHeartbeatPeriod" > 
<soap : operation 
soapAction="http: //www. 3gpp.org/ftp/specs/archive/32_series/32 . 356#setHeartbeatPeriod" 
style= " document " / > 
< input > 

<soap:body use=" literal "/> 
</ input > 
<output> 

<soap:body use=" literal "/> 
</output> 
<f ault name= " setHeartbeatPeriodFault " > 

<soap: fault name=" setHeartbeatPeriodFault" use=" literal "/> 
</fault> 
</operation> 
</binding> 
<service name="CSIRPService" > 

<port name="CSIRPOperationslPort" binding=" csIRPSystem: CSIRPOperationsl" > 

<soap : address location="http : //www. 3gpp . org/f tp/specs/archive/32_series/32 . 356#CSIRP"/> 
</port> 
<port name="CSIRP0perations2Port" binding= "csIRPSystem: CSIRPOperat ions2 " > 

<soap: address location="http : //www. 3gpp.org/ftp/specs/archive/32_series/32 . 356#CSIRP"/> 
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</port> 

<port name="GenericIRPPort" binding="genericIRPSystem:GenericIRPBinding" > 

<soap : address location="http : //www. 3gpp . org/f tp/specs/archive/32_series/32 . 316#GenericIRP"/> 
</port> 

<port name="Notif icationlRPNtf Port " binding="ntf IRPNtf SystemrNotif icationlRPNtf " > 
<soap: address 
location="http: //www. 3gpp.org/ftp/specs/archive/32_series/32 . 3 6#Not if icationlRPNtf "/> 
</port> 
</service> 
</def initions> 
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